home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / mis_util / obj_tool / manual.txt next >
Text File  |  1994-02-17  |  6KB  |  171 lines
  1.    ObjTool 2.3  Copyright (c) 1990-1993  Thomas G. Hanlin III
  2.  
  3.  
  4.  
  5. ObjTool is designed to manipulate .OBJ files.  It can search
  6. them, check them for validity, repair checksums, rename or
  7. delete symbols, and display stats.  ObjTool is protected by
  8. copyright, but may be distributed freely provided that it is
  9. not altered in any way.
  10.  
  11. Switches can be abbreviated to any extent, as long as there are
  12. enough letters for the utility to recognize them.  Switches can
  13. be repeated, in which case all of the values specified are
  14. used.  For example:
  15.  
  16.    OBJTOOL *.OBJ /DISPLAY=EXTERNAL /DISPLAY=PUBLIC
  17.  
  18. is the same as:
  19.  
  20.    OBJTOOL *.OBJ /DISPLAY=EXTERNAL,PUBLIC
  21.  
  22. and might be abbreviated as something like this:
  23.  
  24.    OBJTOOL *.OBJ /DISP=EXT,PUB
  25.  
  26.  
  27.  
  28. The following switches are supported:
  29.  
  30.   /CHECK
  31.   /DATE condition date
  32.   /DELETE = LANGUAGE, LIBRARY
  33.   /DISPLAY = ALL, EXTERNAL, LANGUAGE, LIBRARY, MODULE, PUBLIC, TYPE
  34.   /EXCLUDE filespec[, filespec]
  35.   /FILTER = BASIC
  36.   /HELP  or  /?
  37.   /INCLUDE filespec[, filespec]
  38.   /NOBACKUP
  39.   /PAGE
  40.   /REGISTER
  41.   /RENAME = EXTERNAL, LIBRARY, PUBLIC oldname newname
  42.   /REPAIR
  43.   /SEARCH = ALL, EXTERNAL, LANGUAGE, LIBRARY, MODULE, PUBLIC 'name'
  44.   /SIZE condition size
  45.   /TIME condition time
  46.  
  47. A "condition" is any of the following:
  48.  
  49.    EQ  or  .EQ.     equal
  50.    GE  or  .GE.     greater than or equal
  51.    GT  or  .GT.     greater than
  52.    LE  or  .LE.     less than or equal
  53.    LT  or  .LT.     less than
  54.    NE  or  .NE.     not equal
  55. /CHECK
  56.    Each internal record of an .OBJ file is given a checksum
  57.    when it is created.  This switch tells ObjTool to check the
  58.    checksum and see whether it is still valid.  If the checksum
  59.    isn't valid, the .OBJ has been damaged or tampered with.
  60.    See also /REPAIR.
  61.  
  62.  
  63. /DATE condition date
  64.    This switch allows you to screen files by date.  ObjTool
  65.    will process only files that match your date condition(s).
  66.    See the first page for a list of valid conditionals.
  67.  
  68.  
  69. /DELETE = LANGUAGE, LIBRARY
  70.    This switch allows you to delete the language record and/or
  71.    default library specification.  The language record is for
  72.    informational purposes only and may be readily deleted to
  73.    make the .OBJ smaller.  The default library record is not
  74.    necessarily needed if the .OBJ is not the main module, but
  75.    is quite short and won't make much of a size difference.
  76.    You should probably leave it be unless you have a different
  77.    reason for wanting it gone.
  78.  
  79.  
  80. /DISPLAY = ALL, EXTERNAL, LANGUAGE, LIBRARY, MODULE, PUBLIC, TYPE
  81.    This switch tells ObjTool what information (besides the file
  82.    name) to display about the files it processes.
  83.  
  84.  
  85. /EXCLUDE filespec[, filespec]
  86.    This switch allows you to exclude files from processing by
  87.    name.  You may use wildcards, but not drive or path specs.
  88.  
  89.  
  90. /FILTER = BASIC
  91.    This switch activates an array of filters which configure
  92.    ObjTool for more convenient handling of compiled BASIC
  93.    files.  It makes sure that any EXTERNALs and PUBLICs you
  94.    enter are converted to uppercase and screens out BASIC's
  95.    runtime support routines from the .OBJ's externals list.
  96.  
  97.  
  98. /HELP  or  /?
  99.    This switch provides information on ObjTool.  If output is
  100.    going to the display, a command summary is shown.  If output
  101.    has been redirected, a user manual is generated.
  102.  
  103.  
  104. /INCLUDE filespec[, filespec]
  105.    This switch allows you to include files from processing by
  106.    name.  The /INCLUDE switch isn't really necessary, since
  107.    anything that isn't a switch is presumed to be an include
  108.    filespec.  Filespecs may include full paths and wildcards.
  109. /NOBACKUP
  110.    When requested to alter an .OBJ file, ObjTool normally makes
  111.    a backup copy of the original, using the extension .0BJ
  112.    (with a zero, not an "o"). Use /NOBACKUP if you do not want
  113.    backup files made.  This will improve operation speed.
  114.  
  115.  
  116. /PAGE
  117.    This switch causes output to be paged.  If output is going
  118.    to the display, you will be prompted to press a key to
  119.    continue when the screen is full.  If output has been
  120.    redirected, this switch causes a formfeed every 55 rows.
  121.  
  122.  
  123. /REGISTER
  124.    This switch provides information on how to register ObjTool.
  125.    If output is going to the display, registration information
  126.    is shown.  If output has been redirected, a registration
  127.    form is generated instead.
  128.  
  129.  
  130. /RENAME = EXTERNAL, LIBRARY, PUBLIC oldname newname
  131.    This switch allows you to rename an external symbol, a
  132.    default library specification, and/or a public symbol. It is
  133.    most likely to be used to resolve naming conflicts between
  134.    two libraries for which you don't have source code. In such
  135.    a case, all you need to do is extract the .OBJs from one
  136.    library into a fresh directory, and use /REN=EXT,PUB to
  137.    change every occurrence in the library at once.
  138.  
  139.  
  140. /REPAIR
  141.    Each internal record of an .OBJ file is given a checksum
  142.    when it is created.  This switch tells ObjTool to create a
  143.    new checksum for each record based on the current data.  In
  144.    effect, it repairs the .OBJ after modifications have been
  145.    made to it-- say, if you patched the .OBJ using a binary
  146.    editor.  See also /CHECK.
  147.  
  148.  
  149. /SEARCH = ALL, EXTERNAL, LANGUAGE, LIBRARY, MODULE, PUBLIC "name"
  150.    This switch lets you search for a keyword in various parts
  151.    of an .OBJ file.  If the keyword is not found, the file will
  152.    not be processed by ObjTool.  Searches are done by the
  153.    following rules:
  154.       EXTERNAL and PUBLIC searches are case-sensitive,
  155.          unless /FILTER=BASIC is on.
  156.       LIBRARY searches are not case-sensitive.
  157.       LANGUAGE and MODULE searches are not case-sensitive,
  158.          and match if the name is anywhere within the string.
  159.       The name only needs to have quotation marks around it if
  160.          it contains a space.
  161. /SIZE condition size
  162.    This switch allows you to screen files by size.  ObjTool
  163.    will only process files that match your size condition(s).
  164.    See the first page for a list of valid conditionals.
  165.  
  166.  
  167. /TIME condition time
  168.    This switch allows you to screen files by time.  ObjTool
  169.    will only process files that match your time condition(s).
  170.    See the first page for a list of valid conditionals.
  171.